2026 08 20 Windows 11 Claude Desktop + Claude Code 설치 매뉴얼

title: Windows 11 Claude Desktop + Claude Code 설치 매뉴얼

created: 2026-08-20

status: inbox

source_type: authored-note

knowledge-candidate: true

tags:

- Claude

- Claude Desktop

- Claude Code

- Windows 11

- 설치 가이드

Windows 11 Claude Desktop + Claude Code 설치 매뉴얼

기준일: 2026-08-20

대상: Windows 11 초보자

목표: Claude Desktop과 Claude Code를 불필요한 프로그램 없이 오류 가능성을 줄여 설치한다.

먼저 알아둘 것

1. 설치 전 확인

1-1. Windows와 CPU 종류 확인

설정 → 시스템 → 정보 → 시스템 종류에서 확인한다.

Claude Code Native의 공식 최소 조건은 Windows 10 1809 이상, RAM 4GB 이상, x64 또는 ARM64, 인터넷 연결이다. Windows 11은 조건에 들어간다.

1-2. Claude 계정과 이용 권한 확인

2. Git for Windows 설치

2-1. 다운로드

공식 페이지:

CPU에 맞는 설치파일을 선택한다.

2-2. 설치 중 반드시 확인할 항목

설치 화면에서 PATH 관련 항목이 나오면 반드시 다음을 선택한다.

Git from the command line and also from 3rd-party software

이 항목을 선택해야 Claude Desktop과 다른 개발도구가 Git을 찾기 쉽다.

나머지는 특별한 이유가 없으면 기본값을 사용한다.

2-3. 설치 확인

설치가 끝나면 기존 PowerShell을 닫고 새 PowerShell을 연다.

git --version
where.exe git

정상 예시:

git version 2.xx.x.windows.x
C:\Program Files\Git\cmd\git.exe

3. Claude Desktop 설치

3-1. 다운로드와 설치

공식 페이지:

1. Windows x64 또는 Windows ARM64를 CPU에 맞게 선택한다.

2. 설치파일을 실행한다.

3. Windows 권한 확인(UAC)이 나오면 설치를 허용한다.

4. 설치가 끝나면 Claude Desktop을 실행한다.

5. Claude 계정으로 로그인한다.

3-2. Code 탭 확인

1. Claude Desktop에서 Code 탭을 연다.

2. 환경(Environment)에서 Local을 선택한다.

3. 작업할 프로젝트 폴더를 선택한다.

4. 처음에는 권한 모드를 보수적으로 Manual로 시작한다.

5. 간단한 파일 목록 확인이나 읽기 작업으로 동작을 확인한다.

Git is required 오류가 나오면:

1. Git for Windows가 설치됐는지 확인한다.

2. git --version이 새 PowerShell에서 동작하는지 확인한다.

3. Claude Desktop을 완전히 종료한다.

4. 작업 표시줄 트레이에 남은 Claude도 종료한다.

5. Claude Desktop을 다시 실행한다.

4. 터미널용 Claude Code CLI 설치 — 선택 사항

Claude Desktop의 Code 탭만 사용할 사람은 이 단계를 건너뛰어도 된다.

터미널에서 프로젝트 폴더로 이동해 claude를 직접 실행하려는 경우에만 설치한다.

4-1. PowerShell Native 설치 — 공식 권장 경로

새 PowerShell을 열고 다음 명령을 실행한다. 일반 Native 설치에는 관리자 권한이 필요하지 않다.

irm https://claude.ai/install.ps1 | iex

4-2. CMD 대체 명령

PowerShell이 아니라 CMD를 사용하는 경우에는 다음 명령을 사용한다.

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

PowerShell 명령과 CMD 명령을 서로 바꿔 실행하지 않는다.

4-3. WinGet 대체 경로

공식 설치 스크립트가 네트워크 문제로 실패할 때 대체로 사용한다.

winget install Anthropic.ClaudeCode

WinGet 설치는 기본적으로 자동 업데이트되지 않을 수 있다.

4-4. CLI 설치 확인과 로그인

설치 직후에는 기존 터미널을 닫고 새 PowerShell을 연다.

claude --version
claude doctor

프로젝트 폴더에서 실행한다.

cd C:\경로\프로젝트
claude

첫 실행 때 브라우저 로그인 화면이 열린다. 브라우저가 자동으로 열리지 않으면 화면의 안내에 따라 URL을 복사해 로그인한다.

5. Node.js·WSL2·기타 선택 구성

Node.js

다음 경우에만 설치한다.

Claude Code Native 설치만을 위해 Node.js를 설치하지 않는다.

이 문서에서는 다음 npm 전역 설치를 사용하지 않는다.

npm install -g @anthropic-ai/claude-code

현재 초보자에게는 공식 권장 Native 설치가 더 단순하다. npm 설치를 선택하면 Node.js 버전과 PowerShell 실행 정책 문제를 별도로 해결해야 할 수 있다.

WSL2

다음 경우에만 설치한다.

일반 Windows 프로젝트의 Native Claude Code에는 WSL2가 필요하지 않다. WSL1은 일부 샌드박싱 기능을 지원하지 않으므로 Linux 환경이 필요하면 WSL2를 사용한다.

기타

6. Windows에서 자주 생기는 오류

`irm is not recognized`

CMD에서 PowerShell 명령을 실행한 경우다. PowerShell에서 다시 실행한다.

`&& is not valid`

PowerShell에서 CMD 명령을 실행한 경우다. 명령에 맞는 터미널을 사용한다.

`'claude' is not recognized`

설치 후 기존 PowerShell을 사용하고 있을 가능성이 높다.

1. PowerShell을 닫는다.

2. 새 PowerShell을 연다.

3. 다시 실행한다.

claude --version

`claude`를 실행했는데 Claude Desktop이 열림

구버전 Claude Desktop이 WindowsApps\Claude.exe를 등록해 CLI보다 먼저 실행하는 문제일 수 있다.

where.exe claude

Claude Desktop에서 다음을 실행한다.

Help → Check for Updates

Desktop을 완전히 종료하고 새 PowerShell을 연 뒤 다시 확인한다. 정상 Native CLI 경로는 대체로 다음과 같다.

%USERPROFILE%\.local\bin\claude.exe

Desktop Code 탭에서 `Git is required`

설치 스크립트에서 403·HTML·네트워크 오류

프록시·방화벽·회사 네트워크에서 설치 스크립트가 차단됐을 수 있다.

1. 네트워크를 확인한다.

2. 새 PowerShell에서 다시 시도한다.

3. 계속 실패하면 WinGet을 사용한다.

winget install Anthropic.ClaudeCode

WSL에서 `Exec format error`

WSL1이나 잘못된 실행환경일 수 있다. Linux 환경이 꼭 필요하다면 WSL2 전환을 검토한다.

wsl --set-version  2

7. 최종 검증 체크리스트

공식 출처